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2.1  General  Purpose 

Module  PREPALOC  (executed  after  PLANSET)  has  four  major  capabilities: 
updating  of  weapon  group  and  target  attributes,  modification  of  target 
values,  damage  constraints  and  height-of-burst  specification,  prepara- 
tion of  data  for  the  fixed  weapon  assignment  capability  of  module 
ALOC,  and  the  geographical  related  parameters. 

Weapon  groups  formulation  resides  within  module  PLANSET.  PREPALOC  per- 
mits the  user  to  add  weapon  strikes  (called  overallocation)  to  weapon 
groups  whereby  providing  the  allocation  greater  flexibility  in  making 
assignments  which  ignore  serial  constraints.  The  allocator  attempts 
to  assign  the  true  inventory  plus  the  added  weapons.  The  Sortie  Genera- 
tion subsystem  selects  only  the  inventory  number  of  strikes. 

The  second  major  capability  of  this  module  is  the  modification  of  the 
target  characteristics,  VTO,  MINKILL,  and  MAXKILL.  VTO  is  the  value 
of  the  target  relative  to  the  others.  MINKILL  is  the  minimum  fraction 
of  value  that  must  be  destroyed,  and  MAXKILL  is  the  maximum  desired 
fraction  destroyed.  Any  of  these  parameters  may  be  changed  for  any 
target.  The  change  requests  can  change  these  parameters  for  a single 
target  or  for  a set  of  targets.  The  set  of  targets  for  which  a change 
is  requested  is  identified  by  target  class,  type,  and  individual  iden- 
tifier (target  designator  code  (DESIG)),  or  any  combination  of  these. 

For  complex  targets,  the  class,  type,  and  designator  code  of  each  com- 
ponent will  be  checked  to  determine  if  a target  parameter  for  the  com- 
plex is  to  be  changed. 

An  additional  planning  factor  which  can  be  modified  in  this  program  is 
weapon  height  of  burst.  In  the  absence  of  any  user  specifications, 

QUICK  uses  the  height  of  burst  for  each  weapon/target  combination  that 
produces  the  most  damage.  However,  the  user  can  specify  use  of  air  or 
ground  bursts  in  preference  to  the  optimal  height.  The  user  can  re- 
quest ground  or  air  bursts  on  the  basis  of  weapon  type,  target  designa- 
tor code,  target  type,  target  class,  target  country  location,  or  target 
region. 

The  third  major  capability  is  the  request  for  allocation  of  specific 
weapons  to  specific  targets.  (These  requests  are  called  "fixed  assign- 
ments.") This  fixing  of  weapons  to  targets  enables  the  user  to  deter- 
mine part  of  the  weapon  allocation  while  leaving  the  allocation  module 
free  to  determine  the  remaining  allocation.  In  addition,  the  time  of 
arrival  at  target  or  salvo  launch  number  can  be  fixed  for  missile  wea- 
pons. This  information  will  be  passed  to  module  PLANOUT  which  will  ad- 
just the  launch  time  accordingly.  The  specified  fixed  assignment  of 
weapons  remains  in  effect  for  the  remainder  of  the  plan  generation  proc- 
ess. Later  modules  will  retain  the  assignments  as  best  possible. 
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(For  example,  it  is  possible  to  fix  a set  of  weapons  from  a weapon  group 
with  multiple  independently  targetable  reentry  vehicles  (MIRV)  in  such 
a manner  that  there  are  no  feasible  footprints  that  cover  that  target 
set  adequately.  In  that  case,  some  of  the  fixed  assignment  requests 
must  be  ignored.) 

The  fourth  major  capability  is  the  calculations  and  IDS  storage  of  all 
distances  and  attrition  between  corridor  doglegs  for  use  by  other  proces- 
sors. Also  the  distance  between  depenetration  corridor  and  recovery 
bases  is  calculated  and  stored. 


2.2  Input 

2.2.1  General . Text  English  commands  to  this  module  permit  the  setting 
of  new  target  values,  MINKILL  or  MAXKILL  as  well  as  specifying  weapon 
height  of  burst.  Also  certain  gaming  parameters  are  set  which  define 
the  game  to  be  executed.  One  final  consideration  is  permitting  the  user 
to  directly  assign  weapons  to  individual  targets. 

| This  module  recognizes  the  verb  PREPARE  and  adverbs  SETTING,  FIX,  RECALC, 
and  ONPRINTS  (request  for  optional  prints) . The  general  form  of  the  com- 
mand is: 


PREPARE 


RECALC 


3 


SETTING 


^game-parameter  j j value  J 

^ (attribute-1,  attribute-2)  | EQUAL  1 (vaiue>  value)  j^AND 
(value , value)  . . .J  j ^ 

FIX  (DISIO  j,  GROUP  ^ jj|jggj]l 


[ 

(desig  desig j A value  ^ value  j )_ 
j^AND  (desig  desig  j value  value  j 

^ONPRINTS  number  number , first-last  number  . . 


( EQUAL  j 

I — I 


•]] 


•] 


2.2.2  The  RECALC  Adverb.  The  presence  of  this  adverb  causes  the  PREPALOC 
module  to  carryout  the  following  functions: 

o Calculation  and  storage  of  geographic  data 


t ) 
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o Calculation  of  weapon  overallocation  data  and  salvo  information 

o Presetting  of  gaming  parameters  to  defaults. 

Absence  of  the  RECALC  adverb  will  cause  PREPALOC  to  bypass  these  functions. 
The  user  may  wish  to  bypass  these  functions  in  order  to  save  processing 
time  if  the  PREPALOC  module  has  already  been  employed.  Fixed  assignments 
normally  have  been  entered  after  an  execution  of  PREPALOC  in  the  RECALC 
n»de.  Non-RECALC  execution  modes  (with  no  intervening  tape  RESTORES) 
simply  adds  data  to  the  existing  data  base. 

2.2.3  The  SETTING  Adverb.  Two  main  sets  of  data  are  considered  under 
this  clause.  The  first  permits  the  definition  of  variables  that  will 
finalize  the  game  scenario  being  executed.  The  second  allows  the  user 
to  set  attributes  in  various  combinations  of  subsets  whereby  target 
value,  MINKILL,  MAXKILL  or  height-of-burst  overrides  previous  inputs  or 
calculations. 

2.2. 3.1  Gaming  Parameters.  The  user  has  the  capability  to  input  values 
for  parameters  given  in  table  1.  If  inputs  are  absent,  default  values 
are  used.  Simply,  values  are  entered  as: 

INITSTRK-1 

For  any  given  weapon  group,  weapons  will  be  added  for  sortie  generation 
constraint  considerations.  The  number  of  weapons  in  each  group  will  be 

WEAPONS* (1.0  + PEX  + (EXN/VEHICLES) ) 

where  WEAPONS  and  VEHICLES  are  PLANSET  determined;  PEX-PEXBOMB,  PEXMISS, 
or  PEXMIRV ; and  EXN=EXNBOMB , EXNMISS,  or  EXNMIRV. 

2. 2. 3. 2 Target  Modifications.  The  target  modification  portion  of  the 
setting  clause  allows  the  user  to  change  target  value,  minimum  or  maxi- 
mum required  destruction  fraction,  and  height  of  burst  on  any  target  or 
set  of  targets.  In  the  general  command  sentence  given  above,  generic 
word  attribute-1  refers  to  the  identification  of  the  target  set  over 
which  a specific  change  is  to  be  effective.  Generic  word  attribute-2 
refers  to  the  attribute  that  is  to  be  changed.  Therefore: 

attribute-1  = DESIG  (designator  code),  TYPE  (type  name),  CLASS  (target 
class  name),  CNTRYL  (target  country  location),  or  IREG 
(target  region) 

and 

attribute-2  - VALUE  (target  value),  MINKILL  (minimum  value  destroyed), 
MAXKILL  (maximum  value  destroyed),  or  IDHOB  ((target 
height  of  burst  specification),  'AIR'  or  'GROUND') 
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Table  1.  Game  Belated  Parameters 


MNEMONIC  DEFAULT  RANGE 


DESCRIPTION 


INITSTRK  1 1 or  2 


CORMSL  0.0  0.0-1. 0 


CORBOMB 

0.0 

^0.0 

PEXBOMB* 

0.0 

20.0 

* 

EXNBOMB 

3.0 

0.0-1000.0 

PEXMISS** 

0.0 

20.0 

EXNMISS 

0.0 

0.0-1000.0 

** 

PEXMIKV 

0.1 

20.0 

** 

EXNMIRV 

2.0 

0.0-1000.0 

Strike  type  (first  or  second).  In 
the  first  strike  case,  the  launch 
timing  is  determined  by  the  other 
two  input  parameters.  In  the  second 
strike  case,  all  alert  weapons  launch 
after  their  specified  alert  delay 
(ALRTDL) , all  nonalert  weapons  launch 
after  their  nonalert  delay  (NLRTDL) , 
and  the  detailed  coordinated  missile 
timing  parameters  in  program  PLANOUT 
are  Ignored. 

Groaa  missile  launch  timing.  Defined 
as  the  fraction  of  missile  flight 
completed  at  time  zero.  A value  of 
0.0  specifies  missile  launch;  a value 
of  1.0  specifies  missile  impact. 

Bomber  launch  timing.  The  number  of 
nautical  miles  prior  to  the  corridor 
entry  that  each  bomber  reaches  at 
time  zero. 

The  fraction  of  bomber  weapons  added 
for  each  weapon  group  for  over  allo- 
cation. 

Vehicle  'loads'  added  to  each  bomber 
group.  A vehicle  'load'  is  the  ratio 
of  the  number  of  weapons  (PLANSET 
determined)  to  the  number  of  vehicles 

Same  as  PEXBOMB  for  non-MIRV  missiles 

Same  as  EXNBOMB  for  non-MIRV  missiles 

Same  as  PEXBOMB  for  MIRV  missiles 

Same  as  EXNBOMB  for  MIRV  missiles 


These  parameters  are  modified  for  bomber  groups  with  less  than  15 
bombers. 

In 

These  variables  must  be  such  that  the  total  number  of  vehibles  per 
group  (including  overallocation)  does  not  exceed  1030  for  bomber  and 
1130  for  missiles. 
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Any  combination  of  target  subsetting  is  permissable  but  there  is  a rank- 
ing order  in  the  final  storage  of  input  values.  The  order  of  priority 
is:  DESIG,  TYPE,  CLASS,  CNTRYL,  I REG.  That  is,  if  a given  target  is 
referenced  by  more  than  one  output  target  set,  the  cited  order  applies. 

Consider: 

(TYPE, VALUE)  = B52.10)  (CNTRYL, VALUE)  - (US, 20)  (CLASS.VALUE)  - 
(MISSIL.10)  (DESIG, VALUE)  » (AB123,30) 

In  terms  of  the  hierarchy,  all  targets  located  within  the  US  will  have  a 
value  of  20;  all  B52s  and  MISSILs  will  have  a value  of  10  (even  if  lo- 
cated within  the  US);  and  the  individual  target  AB123  will  have  a value 
equal  to  30. 

If  some  targets  within  the  given  subset  are  components  of  a target  com- 
plex, the  planning  factors  for  the  complex  would  be  changed  to  agree 
with  the  modified  values  for  the  components.  If  an  attempt  is  made  to 
modify  the  same  planning  factor  for  a complex  target  as  a whole,  and 
also  on  a component  of  that  complex,  the  former  change  will  be  effected 
and  the  latter  change  will  be  ignored. 

In  the  absence  of  a height-of-burst  specification,  the  optimal  height  is 
used.  When  changing  VALUE,  the  normalized  VALUE  should  be  entered. 


In  summary,  then,  this  phrase  of  the  SETTING  clause  is: 


{DESIG  \ 

TYPE  f 
CLASS  > , 

CNTRYL  ( 

IREG  ) 

A setting  of  IDHOB  may  also  be  used  to  preset  height  of  burst  for  a weap- 
on type  (the  attribute  altered  is  WHOB) . 

2.2.4  The  FIX  Adverb.  The  optional  fixed  assignment  clause  specifies 
the  allocation  of  weapons  to  specific  targets.  A fixed  assignment  of 
weapons  from  a specific  group  to  a specific  target  is  maintained  by 
module  ALOC,  which  optimizes  the  assignment  of  the  nonfixed  weapons. 

In  addition,  the  delivery  time  (minutes  relative  to  H-hour)  of  non- 
MIRV  missile  weapons  may  be  specified.  Also  the  salvo  launch  number 
may  be  user  controlled.  Any  one  command  may  not  contain  both  the  salvo 
number  and  arrival  time,  however.  These  direct  cotmnands  are: 


VALUE 
MINKILL 
MAXKILL  / 
IDHOB 


) 


= (value . value) 


FIX  (DESIG, GROUP)  « (AB123.4) 

(DESIG, GROUP, ARRIVE)  = (AD187.6, .5)  AND  (FAOOl.92,1) 
(DESIG, GROUP, SALVO)  = (FE001,7,1) 


The  first  command  fixes  a weapon  from  group  4 to  target  AB123,  and  down- 
time is  dependent  on  the  time  of  flight.  The  second  command  fixes  weapons 
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from  groups  6 and~9S  to  targets  AD187  and  FA001  with  downtimes  of 
.5  and  1,  respectively.  The  third  command  fixes  a weapon  from  group  7 
to  target  FE001  and  the  weapon  will  be  launched  within  the  first  salvo. 

In  many  cases  fixed  assignments  are  made  to  sets  oft  targets  that  have 
sequential  DESIGs.  In  order  to  capture  this  often  used  option,  it  is 
permissible  for  the  user  to  input  a string  of  DESIGs  for  many  targets 
thereby  fixing  one  weapon  group  from  the  indicated  weapon  group  on  each 
tagget.  This  command  is  an  expansion  on  the  individual  assignment  com- 
mand and  is  recognized  by  the  appearance  of  the  word  DESIG  entered  twice 
and  separated  by  a comma.  For  example: 

FIX  (DESIG, DESIG, GROUP, ARRIVE)  = (AB127 ,AB227 , 5 , 1 ,0) 

AND  (AB228,AB230,6, 1 .0) 

Group  5 will  have  weapons  fixed  assigned  to  all  targets  starting  with 
DESIG  AB127  and  ending  with  DESIG  AB227  (101  separate  targets) . The 
alpha-portions  of  these  two  DESIGs  must  be  equal. 

An  additicral  capability  is  provided  by  the  attribute  NUMALOC.  The  user 
specifies  that  more  than  one  weapon  of  the  group  named  be  assigned  to  the 
target  (or  targets)  specified.  For  example: 

FIX  (DESIG,  GROUP,  NUMALOC)  - (AB321,  7,  5) 

j Five  weapons  from  group  7 are  to  be  assigned  to  target  AB321. 

The  following  constraints  apply: 

o No  weapons  from  a bomber  group  may  be  fixed  on  a target  which 
has  been  allocated  more  than  30  weapons. 

o No  more  than  30  weapons  may  be  fixed  on  an  undefended  target 
(MISDEF=0) 

o The  number  of  weapons  in  any  group  is  the  maximum  number  of 
fixed  assignments  which  may  be  made  from  that  group. 

2.2.5  The  ON PRINTS  Adverb.  It  is  not  necessary  to  generate  all  per- 
missible prints  for  every  FREPALOC  execution.  For  this  reason,  the 
ONPRINTS  adverb  permits  the  selection  of  up  to  four  separate  print  re- 
quests numbered  1,  2,  3,  or  4.  Print  request  number  1 supplies  geo- 
graphical related  reports;  request  number  2 supplies  weapon  group  re- 
lated prints;  request  number  3 prints  target  data;  request  number  4 
generates  target  data  as  modified  by  user  inputs. 

The  proper  print  requests  follows  the  ONPRINTS  adverb.  A series  of  num- 
bers (in  any  order)  separated  by  at  least  a single  space  turns  on  the 
print  requests. 
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Options  3 and  4 produces  prints  concerning  the  available  target  list. 

If  desired,  the  user  may  request  a subset  of  targets  to  be  printed  by 
specifying  the  first  and  last  target.  This  is  possible  through  the  use 
of  special  operators  corana  (,)  and  dash  (-).  After  the  number  3 or  4 
the  starting  target  number  to  be  printed  will  follow  the  corana  operator 
and  the  last  target  number  to  be  printed  will  follow  the  dash  operator. 
Consider  the  command: 

ONPRINTS  2 3,10-1297  4,1000 

Prints  for  option  two  will  be  generated;  target  data  for  target  numbers 
between  10  and  1297  will  be  generated  for  option  three;  and  target  data 
for  target  numbers  between  1000  and  the  maximum  value  will  be  generated 
for  option  four.  If  the  corana  operator  is  missing  print  begins  with 
target  number  one. 

2. 3 Output 

2.3.1  Standard  Reports.  Standard  prints  appear  depending  upon  user  em- 
ployment of  specific  options.  Gaining  parameters  (figure  3)  appear  if 
RECALC  is  specified  and/or  any  parameter  is  changed  via  a SETTING  clause. 
The  target  data  summary  (figure  4)  also  appears  in  the  case  of  RECALC  or 
changes.  The  fixed  assignment  summary  (figure  5)  appears  if  the  input 
contains  a FIX  clause. 

2.3.2  Optional  Reports.  Reports  generated  for  print  option  one  are 
given  in  figures  6 through  8;  figure  13  for  option  two;  figure  14  for 
option  three;  and  figure  16  for  option  four. 

2.3.3  Error  Messages.  All  possible  error  messages  produced  for  PREPALOC 
are  explained  in  figure  17. 
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Figure  7.  Print  Option  1:  Depenetration  Corridor  Data 
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Figure  8.  Print  Option  1:  Refuel  Point  Data  Print 
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■Attrition  parameter,  corridor  origin  to  target  (this  value  is  used  as  the  exponent 
in  the  attrition  probability  calculation) 
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UNEXPECTED  END  TO  FIX  CLAUSE 


The  input  FIX  clause  has  ended  in  the  middle  of  a phrase. 

2 ERROR  CAUSED  BY  (5(2X,012)) 

Follows  error  messages  in  FIXWEP.  Fields  contain  octal  dump  of 
offending  input  instruction. 

3 ERROR  IN  SUBJECT  OF  FIX  CLAUSE 

Input  error  occurs  in  subject  — that  is  to  the  left  of  an  equal 
sign. 

4 SKIPPING  TO  NEXT  SUBJECT 

Processing  proceeds  to  next  subject  — that  is  to  next  collec- 
tion to  the  left  of  an  equal  sign. 

5 ERROR  IN  OBJECT  OF  FIX  CLAUSE 

Input  error  occurs  in  object  — that  is  a collection  to  the 
right  of  an  equal  sign. 

6 SKIPPING  TO  NEXT  OBJECT 

Processing  proceeds  to  the  next  object  collection  of  the  current 
subject  or  the  next  subject. 

7 TYPE  OF  VALUE  IN  OBJECT  DOES  NOT  MATCH 

An  alphabetic  value  assigned  to  a numeric  attribute  or  vice 
versa . 

8 NUMBER  OF  ITEMS  IN  OBJECT  ERROR 

Object  collection  does  not  contain  the  same  number  of  items  as 
subject. 

9 ILLEGAL  ATTRIBUTE  IN  FIX  CLAUSE 

Attribute  must  be  DESIG,  GROUP,  SALVO,  ARRIVE  or  NUMALOC 

10  TOO  MANY  ATTRIBUTES  IN  FIX  CLAUSE 

Only  five  attributes  are  allowed  in  any  one  subject. 


Figure  17.  PREPALOC  Error  Messages  (Part  1 of  3) 
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11  ILLEGAL  COMBINATION  OF  ATTRIBUTES 


i 

I 

I 

I 


Only  DESIG  may  appear  twice  — SALVO  and  ARRIVE  are  mutually 
exclusive. 

12  MISMATCH  IN  DESIG  RANGE 

Either  alphabetic  portions  are  not  equal  or  second  numeric  por- 
tion is  less  than  first. 

13  FIXWEP  ASSIGNMENT  HAS  NON-EXISTANT  DESIG  (A6) 

Value  is  DESIG  not  in  data  base. 

14  FIXWEP  ASSIGNMENT  NOT  LEAD  (A6) 

Value  is  DESIG  which  exists  but  is  a non-lead  element  of  a com- 
plex. 

15  FIXWEP  ASSIGNMENT  NOT  IN  LIST  (A6) 

Value  Is  DESIG  which  exists  but  is  not  in  target  list. 

16  FIX  REQUEST  EXCEEDS  GROUP  SIZE  (15)  (A6) 

Group  completely  fixed.  Values  are  group  number  and  desired 
DESIG. 

17  NEGATIVE  LAUNCH  TIME  (15)  (A6)  (F10.5) 

Desired  arrival  time  caused  negative  launch  time.  Values  are 
group  number  DESIG  and  input  arrival  time  (fix  is  still  honored) 

18  NO  SALVO  AVAILABLE  (15)  (A6) 

All  group  salvoes  exhausted.  Values  are  group  number  and  DESIG. 

19  DESIRED  SALVO  NOT  AVAILABLE  (15)  (A6)  (15) 

Selected  salvo  not  available.  Values  are  group  number,  DESIG 
and  preset  salvo  number. 

20  GEOPREP  ENCOUNTERED  NONEXISTANT  DESIG  FOR  RECOV.  BASE  (A6) 

DEPEN.  CORR.  (15) 

Subroutine  GEOPREP  has  found  a nonexistant  recovery  base.  Check 
values  stored  with  corridor.  Values  are  offending  DESIG  and 
corridor  number 

Figure  17.  (Part  2 of  3) 
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21  GEOIN  ENCOUNTERED  NONEXISTANT  DESIG  FOR  RECOV.  BASE  (A  6) 

DEPEN.  CORR.  (15) 

See  message  above. 

22  ERROR  IN  SETTING  CLAUSE 

Clause  contains  Illegal  attribute  name. 

23  ONLY  ONE  SETTING  CLAUSE  FOR  TARGET  ATTRIBUTES  ALLOWED 

All  changes  to  VALUE,  MINKILL,  MAXKILL  and  target  IDHOB  must  be 
In  a single  SETTING  clause. 

24  ERROR  IN  ONPRINTS  CLAUSE 

Error  In  ONPRINTS  clause  syntax  on  option  number  greater  than  4. 


Figure  17.  (Part  3 of  3) 
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3.1  General  Purpose 

t ! The  major  purpose  of  this  module  Is  to  determine  the  optimal  allocation 

of  weapons  to  targets,  using  a Lagrange  multiplier  technique.  The  weap- 
j ons  are  divided  into  weapon  groups.  A group  contains  weapons  of  the 

same  characteristics  which  are  geographically  proximate.  Thus,  weapons 
] are  considered  identical  within  groups.  Each  target  is  considered  in- 

dividually for  weapon  assignment.  When  all  targets  have  been  processed, 
another  pass  over  the  targets  begins.  This  process  continues  until  the 
Lagrange  method  has  allocated  all  the  weapons  to  the  targets.  The  assign- 
ments are  then  entered  in  the  integrated  data  base  for  later  processing. 
The  module  allows  some  extent  of  user  control  over  the  allocation  proc- 
, ess  through  fixed  assignments  restrictions  on  certain  weapon  groups, 

and  general  allocation  control  parameters. 

3.1.1  Modes  of  Execution.  For  a given  execution  of  ALOC,  several  com- 
plete passes  are  made  over  the  target  list.  During  the  first  pass  over 

, the  target  list  many  one-time  calculations  between  weapon  groups  and 

targets  are  determined  and  stored  within  a data  file  (called  the  Weapon/ 
Target  Data  file).  These  one-time  calculations  are  continually  reread 
(not  recalculated)  for  each  non-first  pass  over  the  targets.  If  there 
• are  to  be  further  executions  of  ALOC  and  the  data  base  values  have  not 

been  altered,  the  created  Weapon/Target  Data  file  may  be  used  In  lieu  of 
recalculating  the  one-time  calculations.  Adverb  RECALC  (see  subsection 
3.2)  communicates  the  mode  of  execution  to  module  ALOC.  If  RECALC  Is 

4 present,  the  Weapon/Target  Data  will  be  created;  otherwise,  ALOC  assumes 

the  data  file  to  exist. 

J 3. 1.1.1  RECALC  Mode.  In  this  mode  the  ALOC  module  creates  the  Weapon/ 

Target  Data  file  during  the  first  pass  over  individual  targets.  The 
data  contained  on  the  file  is  then  used  during  successive  passes  with 
the  file  rewound  at  the  outset  of  each  pass.  When  the  file  is  created 
the  data  for  it  is  calculated  without  reference  to  any  user  alterations 
(for  example  range  modifications)  which  are  input  to  the  ALOC  module 
(there  is  a parallel  file  which  contains  altered  data  where  it  is  neces- 
sary) . 

3. 1.1.2  Non -RECALC  Mode.  In  this  mode  the  ALOC  module  uses  a Weapon/ 
Target  Data  file  created  by  a previous  ALOC  run.  Experience  has  shown 
that  many  ALOC  reruns  are  due  to  changes  in  user  directed  constraints, 
data  alterations  or  other  changes  input  to  the  ALOC  module.  As  noted 
in  3. 1.1.1  above  the  Weapon/Target  Data  file  is  created  without  refer- 
ence to  these  execution  time  inputs  and  thus  will  contain  the  same  data 
from  run  to  run.  The  non-RECALC  mode  takes  advantage  of  this  fact  by 
allowing  the  ALOC  module  to  read  the  data  from  the  file  on  pass  one  as 
it  does  on  succeeding  passes. 


3. 1.1.3  Mode  Selection  and  JCL  Consideration.  The  users  selects  the 
RECALC  mode  by  including  the  RECALC  adverb  in  the  input.  If  it  does  not 
appear,  non-RECALC  mode  will  be  assumed.  In  either  case,  either  a tape 
or  file  must  be  included  with  a file  code  of  15.  If  the  user  wishes  to 
create  a Weapon/Target  Data  file  for  use  on  several  runs,  an  appropriate 
entry  should  be  made  in  the  JCL  for  file  code  15. 

3. 1.1.4  Non-RECALC  Mode  Caution.  The  user  should  be  aware  that  indis- 
criminate use  of  the  non-RECALC  mode  will  cause  errors.  In  general,  it 
is  best  to  run  ALOC  in  the  RECALC  mode  following  any  change  to  the  basic 
weapon  or  target  data  or  if  any  modules  which  run  prior  to  ALOC  are  re- 
run. For  example,  the  Weapon/Target  Data  file  is  not  likely  to  be  valid 
between  scenarios  so  that  if  module  DBMOD  is  rerun  with  a new  value  for 
the  86BNARI0  attribute  ALOC  should  be  run  in  RECALC  mode. 


. 


3.1.2  Attack  Increment.  In  the  formulation  of  weapon  assignments,  ALOC 
may  view  either  the  entire  weapon  inventory  or  a selected  subset  as 
assignment  candidates.  In  either  situation,  the  complete  target  list  is 
always  available.  These  methods  of  allocation  permit  assignments  under 
the  attack  increment  concept  where  only  certain  weapon  types  are  con- 
sidered for  a given  execution.  This  control  is  through  weapon  group 
attribute  ATTINC  and  ALOC  input  attribute  ATTPOS.  ALOC  will  consider 
assignments  only  on  those  weapon  groups  where  ATTINC  = ATTPOS;  assume 
assignments  to  be  fixed  where  ATTINC  < ATTPOS;  and  ignore  all  weapon 
groups  where  ATTINC  > ATTPOS.  These  settings  allow  for  allocations  upon 
previously  finalized  allocations.  There  can  be  up  to  nine  separate  exe- 
cutions of  ALOC  where  any  given  allocation  will  have  as  the  starting 
point  the  weapon  assignments  from  all  previous  allocations.  Note  that 
after  each  ALOC  execution  the  user  must  fix  all  assignments  for  further 
executions  of  varying  values  of  ATTPOS.  Any  execution  where  ATTPOS  = 0 
implies  all  weapon  groups  are  to  be  considered. 


3.2 


The  verb  ALLOCATE  initiates  execution  of  the  ALOC  module.  This  verb  has 
11  optional  adverbs  which  the  user  may  use  to  control  ALOC's  functions. 
These  adverbs  are: 

o FLAGREST  User  specifies  weapon  groups  which  are  restricted 
according  to  the  setting  of  the  FLAG  attribute 

o LOCREST  User  specifies  weapon  groups  which  are  restricted 

according  to  the  country  location  of  the  target 


o MINRANGE  User  specifies  changes  to  a group's  minimum  range 


o MIRVREST 

o MODRANGE 


User  specifies  restrictions  to  MIRV  groups  accord- 
ing to  target  class 

User  specifies  modification  to  the  range  of  groups 

o 


32 


CH-1 


o ONPRINTS 

o PUNCH 
o READMUL 

o RECALC 

o SETTING 


User  selects  desired  print  option  and  specifies 
ranges  and  frequencies  for  those  prints 

User  requests  output  of  final  Lagrange  multipliers 

User  specifies  values  for  Lagrange  multipliers  to 
be  used  at  the  outset  of  ALOC  execitlon 

User  specifies  that  the  Weapon  Data  File  must  be 
created  by  ALOC  and  not  read  in 

User  specifies  values  for  ALOC  parameters  other 
than  their  default  values 


o SMAT 


User  specifies  values  for  the  SMAT  array 


The  ALOC  module  will  execute  properly  in  the  absence  of  any  of  these 
adverbs . 


3.2.1  The  FLAGREST  Clause.  This  clause  specifies  interaction  between 
weapon  groups  and  the  target  attribute  FLAG  which  may  have  a value  of 
0-9  inclusive.  (A  value  of  0 indicates  that  no  weapon  is  restricted 
from  that  target  because  of  its  flag.)  In  this  clause,  the  user  speci- 
fies which  groups  are  restricted  and  what  target  FLAG  values  they  may  or 
may  not  attack.  The  general  form  of  the  FLAGREST  clause  is 

T 1 ( INCLUDE  ) 

FLAGREST,  grou£  j.  grou£ Pjpup  I j EXCLUDE 

flag  flag  . . . A flag 

The  adverb  may  be  followed  by  any  number  of  sets  of  inputs  each  consist- 
ing of  three  parts.  First  a set  of  one  or  more  group  numbers  separated 
by  commas  are  supplied  followed  by  either  of  the  two  special  words: 
INCLUDE  or  EXCLUDE.  Third  a set  of  one  or  more  flag  numbers  separated 
by  commas  define  entries  for  attribute  FLAG. 

The  relationship  of  the  group  numbers  to  the  flag  numbers  is  specified 
by  the  intervening  special  word.  If  the  word  is  INCLUDE,  then  the  spec- 
ified groups  are  restricted  from  all  but  the  specified  flags.  If  the 
word  is  EXCLUDE,  then  the  specified  groups  are  restricted  from  the  spec- 
ified flags.  For  example 

FLAGREST  1,2,3  INCLUDE  3,4  5,6  EXCLUDE  7,8 

The  result  of  this  example  would  be  that  groups  1,  2,  and  3 could  not 
attack  targets  where  FLAG  values  were  1,  2,  5,  6,  7,  8,  or  9 and  groups 
5 and  6 could  not  attack  targets  where  FLAG  values  were  7 or  8. 

3.2.2  The  LOCREST  Clause.  This  clause  specifies  interaction  between 
weapon  groups  and  the  country  location  code  of  targets.  In  this  clause, 
the  user  specifies  which  groups  are  restricted  and  what  target  country 


! 


group 


group 


locations  they  may  or  may  not  attack.  The  general  form  of  the  LOCREST 
clause  is: 

f 1 ( INCLUDE  i 

LOCREST  -f.  ...  |xfE8!!R  . . . A £rou£j  j ^LUDE  j 

^ . y country  location  . ...  . SA  country  location^ 

The  adverb  may  be  followed  by  any  number  of  sets  of  inputs,  each  consist- 
ing of  three  parts.  First  a set  of  one  or  more  group  numbers  separated 
by  commas  are  supplied  followed  by  either  of  the  two  special  words: 
INCLUDE  or  EXCLUDE.  Third  a set  of  one  or  more  country  location  codes 
(i.e.,  US,  UR,  etc.)  separated  by  commas  are  entered. 

The  relationship  of  the  groups  to  the  country  codes  is  specified  by  the 
intervening  special  word.  If  the  word  is  INCLUDE,  then  the  specified 
groups  may  not  attack  any  targets  but  those  with  the  specified  country 
locations.  If  the  word  is  EXCLUDE,  the  specified  groups  may  attack  only 
targets  whose  country  locations  are  other  than  those  given. 


An  example  of  a LOCREST  clause: 

LOCREST  1,2,3  INCLUDE  UR,CH  4, 5, 6, 7 EXCLUDE  PO,CZ,BU 

The  result  of  this  example  would  be  that  groups  1,  2,  and  3 could  only 
attack  targets  whose  country  location  codes  were  "UR"  or  "CH",  and 
groups  4,  5,  6,  and  7 could  not  attack  targets  whose  country  codes  were 
"PO",  "CZ"  or  "BU". 

/ 

3.2.3  The  MINRANGB  Clause.  This  clause  allows  the  user  to  specify  a 
value  for  the  RNGMIN  attribute  other  than  that  given  for  a group.  The 
clause  consists  of  a new  minimum  range  value  followed  by  one  or  more 
group  numbers.  Parentheses  are  optional.  The  general  form  is: 


MINRANGE 


(minimum  rar 


group 


g?uP 


group 


As  many  sets  of  values  may  appear  in  a single  clause  as  desired.  The 
user  should  note  that  use  of  this  clause  alters  the  value  of  the  RNGMIN 
attribute  for  this  run  of  ALOC  only  and  does  not  alter  its  data  base 
value  in  any  way.  An  example  of  a MINRANGE  clause  is: 

MINRANGE  (1000,1,2,3,4)  (1500,9,10) 

The  result  would  be  to  set  the  RNGMIN  value  to  1000  for  groups  1,  2,  3 
and  4 and  to  1500  for  groups  9 and  10. 

3.2.4  The  MIRVREST  Clause.  This  clause  allows  the  user  to  specify  re- 
strictions for  MIRV  weapon  types.  These  types  may  be  restricted  to 
particular  target  classes.  In  addition  to  standard  classes,  they  may 
be  restricted  to  complexes  (C0MPLE),  defended  complexes  (COMPLD) , de- 
fended targets  (DEFEND)  and/or  multiple  targets  (MULTI P) . 


♦ 


| The  general  form  of  the  MIRVREST  clause  is: 


MIRVREST 


javload  name  . class 


class 


class 


The  adverb  is  followed  by  any  number  of  sets  of  values  separated  by 
conmas.  The  first  value  is  the  name  of  a MIRV  group's  payload  table. 

The  remaining  values  are  class  names  of  those  targets  which  the  indi- 
cated group (s)  may  attack.  The  parentheses  are  optional.  An  example 
follows. 

MIRVREST  ( MM-III  , COMPLE .COMPLD,  U/I  ) ( POSEID  .BOMBER) 

This  effect  of  this  would  be  to  restrict  weapons  with  the  payload  table 
name  "MM-III"  to  complexes  (defended  or  not)  and  target  class  "U/I". 
Further  weapons  with  the  payload  table  name  "POSEID"  would  only  be  able 
to  attack  single  targets  of  class  "BOMBER".  Note:  Although  this  option 
was  designed  for  MIRV  weapons,  there  is  no  current  restriction  which 
would  prevent  use  of  this  option  for  non-MIRV  weapon  systems. 

3.2.5  The  MODRANGE  Clause.  This  clause  allows  the  user  to  alter  the 
data  base  attributes  RANGE  and  RANGEREF  for  allocation  purposes.  The 
values  of  RANGE  and  RANGEREF  initially  stored  within  the  data  base  are 
not  altered.  Module  ALOC  conducts  the  allocation  with  the  user  directed 
multipliers  values  but  this  information  is  not  passed  to  other  QUICK 
processors . 

The  user  supplies  multipliers  for  RANGE  and  RANGEREF  on  a weapon  group 
basis.  The  general  form  is: 


MODRANGE 


te  multiplier 


group 


group 


refuel  r« 


group 


lltiplier 


The  clause  consists  of  any  number  of  sets  of  values.  The  first  value  of 
the  set  is  a multiplier  for  the  RANGE  attribute  which  is  followed  by  the 
optional  slash  (/)  and  a multiplier  for  the  RANGEREF  attribute.  Follow- 
ing the  multipliers  are  the  group  numbers  to  which  the  multipliers  are 
applicable.  Each  group  number  must  be  preceded  by  a comma.  Numeric 
sets  of  multipliers  may  be  defined  by  leaving  at  least  one  space  between 
each  data  set. 

If  the  multiplier  for  RANGEREF  is  omitted  it  is  treated  as  the  same  as 
that  for  RANGE . 

An  example  of  a MODRANGE  clause  would  be: 


MODRANGE 


(.8/. 9, 1,2, 3)  (.7,4,5) 


The  effect  would  be  to  multiply  the  RANGE  attribute  by  .8  and  the 
RANGEREF  attribute  by  .9  for  groups  1,2  and  3.  Also,  both  the  RANGE 
and  RANGEREF  attributes  of  groups  4 and  5 would  be  multiplied  by  .7. 
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3.2.6  The  ONPRTNTS  Clause.  This  clause  allows  the  user  to  control  the 
appearance  of  various  print  options.  The  options  available  are  detailed 
in  table  2.  Each  option  may  be  selected  and  the  frequency  of  its  appear- 
ance (s)  controlled  as  to  the  pass  and/or  targets.  The  control  parameters 
available  and  their  default  settings  are: 


First  pass  of  appearance  - default  pass  1. 

Last  pass  of  appearance  - default  pass  9999 

First  target  of  appearance-  default  target  1 

Last  target  of  appearance  - default  target  9999 

Frequency  of  appearance  as  to  target  - default  every  target  (1) 


I 


In  addition,  options  1,  2,  4 and  16  are  initially  selected  with  the  fre- 
quency of  option  4 set  at  50.  The  user  may  request  that  these  options 
not  appear . The  general  form  of  the  ONPRINTS  clause  is  : 


ONPRINTS  option  £ A first  target  - last  target  j_  frequency j 
|^*  first  pass  z.  last  pass  j j^NOT  option  j 


This  clause  has  a number  of  optional  forms.  Following  the  adverb  the 
user  may  input  any  number  of  sets  of  values  in  various  forms.  A single 
number  (in  the  range  1-30,  see  table  10)  will  cause  that  option  to 
appear  with  default  controls.  If  the  user  wishes  to  surpress  a default 
option  (i.e.,  1,  2,  4,  or  16)  the  option  number  is  preceded  by  the  NOT 
operator. 


User  alterations  to  target  control  defaults  are  preceded  by  a comma.  A 
number  following  the  comna  will  be  used  as  a first  target  control.  A 
number  preceded  by  a hyphen  will  be  used  as  a last  target  and  a number 
preceded  by  a slash  will  be  used  as  a frequency.  Only  those  controls 
which  the  user  wishes  to  charge  need  be  included.  Similarly,  the  pass 
controls  are  preceded  by  an  asterisk. 

For  example: 

ONPRINTS  NOT  4 5,50*-2  6,/4 

Would  cause  option  4 to  be  surpressed,  option  5 to  appear  beginning 
with  target  50  and  for  passes  one  and  two,  and  option  6 to  have  a fre- 
quency of  4. 


3.2.7  The  PUNCH  Clause.  This  adverb  allows  the  user  to  request  that 
the  final  Lagrange  multiplier  be  saved  on  an  output  unit.  The  format 
used  for  this  output  is  such  that  it  can  be  assessed  on  later  runs  by 
the  READMUL  clause.  The  general  form  of  the  PUNCH  clause  is 

PUNCH  [ NEW  “ unit  number j 

The  optional  portion  is  used  to  specify  an  output  unit  other  than  43 

(system  puv.ch) . 


t 
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Table  2.  Description  of  Print  Option  Numbers 
for  Program  ALOC  (Part  1 of  2) 

OPTION 

DESCRIPTION  OF  PRINT 

1 

Input  weapon  data 

2 

Main  summary  prints  after  weapons  have  been  allocated  to 
target 

3 

Not  used 

4 

Print  for  all  weapon  groups  the  Lagrange  multipliers,  the 
total  number  of  weapons  allocated  (RNALL) , and  number  of 
weapons  allocated  (RNALL),  and  number  of  weapons  allocated 
this  pass  (NALL)  with  total  weapon  value  and  value  of  error 
in  allocation 

5 

Print  of  data  on  target  weights  and  rates  of  change  of 
weights 

6 

Target  input  data  before  allocation  begins 

7 

Basic  weapon/target  interaction  data  before  allocation  of 
weapons  to  target 

8 

Risk  array  before  allocation  begins  on  target 

9 

Summary  of  weapons  assigned  to  present  target  and  marginal 
values  for  each  (see  option  22  for  companion  print  of  po- 
tential weapons) 

10 

Input  data  to  the  single  target  allocator  (STALL)  --  i.e., 
output  from  WAD 

11 

Initial  values  for  lambdas,  VALWPNS  and  VALERR,  at  start 
of  module  only 

12 

Debugging  print  showing  synopsis  of  calculation  of  actual 
payoff  by  WAD 

13 

Debugging  print  showing  after-the-fact  synopsis  of  poten- 
tial weapon  added  and  weapon  deleted  payoff  calculations 
by  WAD 

14 

Not  used 

15 

Not  used 

( ) 
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OPTION  DE - "l  DESCRIPTION  OF  PRINT 

16  Defense  level  and  attack  mode  print  for  targets  with  ter- 

minal ballistic  missile  defense 


17  Not  used 

18  Not  used 

19  Planning  factor  summary  for  targets  with  terminal  ballis- 
tic missile  defenses 

20  Summary  of  WADOUT  cost  payoff  benefit,  etc. 

21  Complete  listing  of  allocation  error  estimates  (ALLEREST) 

22  Summary  of  marginal  payoff  data  for  potential  weapons  fol- 
lowed by  resulting  STALL  decision:  a companion  print  to 
print  number  9 

23  Printout  of  timing  information 

24  Memory  dump  and  run  termination 

25  List  of  inactive  switches  for  each  weapon  group  as  related 
to  current  target 


26  Print  of  preferred  corridors  and  computed  penetration  prob- 
abilities for  each  penetration  corridor  for  all  bomber 
groups  relative  to  current  target;  available  only  on  first 
pass 

27  Best  rate  of  return  for  missile  allocation  in  DEFALOC 

28  Debugging  print  of  allocations  and  payoff  computed  in 
RESVAL 

29  Print  of  Lagrange  multiplier,  balance  parameter,  and  stock- 
pile for  salvoed  missiles 

30  Print  of  bomber  payload  indicators  and  allocation  fractions 


♦ 


3.2.8  The  READMUL  Clause-  This  clause  allows  the  user  to  specify  start- 
ing lagrange  multipliers  for  the  ALOC  module.  These  multipliers  fall  in- 
to six  categories  and  are  all  originally  set  to  1.  Through  this  clause, 
the  user  may  also  specify  an  input  unit  created  by  the  punch  adverb  in  a 
previous  run.  The  general  form  is 


READMUL  OLD  = unit 


’ all 

CLASS 

TYPE 

REGION 

, . index  . lambda  value 

GROUP 

OTHER 



The  "OLD"  phrase  gives  an  input  unit  created  by  PUNCH.  Each  other  value 
is  specified  by  a set  of  values  the  first  of  which  is  one  of  the  word 
shown  in  the  form  above,  the  second  is  an  index  identified  by  the  first, 
and  the  third  is  the  desired  starting  multiplier.  The  ALL  form  should 
not  have  an  index.  In  addition,  the  user  may  substitute  the  alphanumeric 
name  of  a weapon  type  (TYPE)  for  its  index. 

3.2.9  The  RECALC  Clause.  This  clause  consists  only  of  the  adverb 
RECALC.  By  including  this  adverb  the  user  indicates  that  there  is  no 
Weapon/Target  Data  file  available  from  a previous  ALOC  execution.  This 
adverb  should  be  included,  therefore,  on  any  run  where  no  such  file 
exists  from  a previous  run  or  where  alterations  in  the  weapon  or  tar- 
get data  have  rendered  the  information  on  the  available  file  invalid. 

3.2.10  The  SETTING  Clause.  This  clause  is  a standard  SETTING  clause 
applied  to  the  allocation  parameters  identified  in  table  3.  The  default 
values  for  these  parameters  is  shown  in  table  3 also.  The  user  may  not 
alter  any  attributes  other  than  these  parameters  via  this  clause.  For 
example : 

SETTING  B PEN FAC =1  SNSTYTY=.05  PKTX=. 95 

The  setting  of  values  via  the  SETTING  clause  alters  them  only  for  the 
particular  run  of  ALOC.  After  the  run  they  will  revert  to  their  orig- 
inal values.  The  user  should  note  that  all  attributes  identified  in 
table  3,  other  than  ATTPOS,  reside  in  the  ALCPRM  record  which  should 
be  preset  to  its  default  values  at  some  point  prior  to  the  first  execu- 
tion of  ALOC.  An  example  of  setting  these  values  is: 

CHANGE  WHERE  CLASS  = ALCPRM 

SETTING  IMATCH=0  TARFAC  = .1  BPENFAC  - 1 

PKTX  *=  0 RADPX  = 0 MINDAMAG  = 0 FIXOPT  = 'TRUE'  LOWFAC  - 0 

PROBLOW  - 0 HIGHFAC  * 0 PROBHIGH  =0  LAW  = ’POWER’  TINTFAC  = 1 

CORR  = .5  C0RR2  = 0 FACMIRV  = 0 RINTPRD  = 2 RATIOINT  = 2 


i 
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NAME 

IMATCH 


TARFAC 

BPENFAC 

PKTX 

RADPX 

MINDAMAG 

FIXOPT 


Table  3.  Input  Parameter  Card  Specifications 
(Part  1 of  6) 


RANGE  DEFAULT  DESCRIPTION 


Standard  0 
integer 


20.0  0.1 


20. 0 1.0 


0. 0-1.0  0.0 


0. 0-1.0  0.0 


Controls  the  method  used  to  determine 
if  a weapon  allocation  has  met  the 
required  minimum  destruction  fraction 
specified  by  MINKILL.  If  IMATCH  is  0, 
the  calculation  of  fraction  killed 
includes  the  time  dependence  of  tar- 
get value.  If  IMATCH  is  not  equal  to 
0,  the  fraction  calculation  does  not 
consider  time  dependence  of  target 
value. 

Multiplies  the  level  of  terminal  bomber 
defense  on  each  target  (TARDEF) . Used 
to  increase  or  decrease  all  local  bom- 
ber defenses. 

Multiplies  attrition  rates  for  bomber 
penetration  given  in  the  data  base. 
Normally  should  be  equal  to  1.0,  but 
can  be  used  to  test  alternative  assump- 
tions without  changing  the  data  base. 

Probability  of  missile  warhead  kill  by 
one  terminal  ballistic  missile  defense 
interceptor . 

Probability  of  missile  warhead  kill  by 
a random  area  ballistic  missile  defense. 


0. 0-1.0  0.0 


TRUE,  TRUE 

FALSE, 


Minimum  fraction  of  original  value  of 
a target  without  terminal  ballistic 
missile  defenses  that  must  be  destroyed 
by  each  weapon  allocated  to  the  target. 
If  the  default  option  is  not  used,  this 
constraint  may  cause  nonconvergence  by 
not  allowing  ALOC  to  put  down  all  the 
weapons.  The  fix  for  this  case  is  to 
reduce  MINDAMAG  or  reduce  weapon  inven- 
tory. 

Fixed  assignment  option.  If  TRUE,  fix 
as  in  data  base  in  FALSE  ignore  fix 
requests . 


40 


CH-1 


Table  3.  (Part  2 of  6) 


DESCRIPTION 


DEFAULT 


RANGE 


NAME 


Multiplier  of  the  nominal  level  of 
terminal  ballistic  missile  defense. 
Represents  the  lower  estimate  of  the 
Defense  level  (see  PROBLOW) . 


LOWFAC  0. 0-1.0  0.0 


Probability  that  the  level  of  terminal 
ballistic  missile  defense  is  degraded 
by  the  factor  LOWFAC;  e.g.;  if  the 
nominal  number  of  terminal  BMD  inter- 
ceptors is  MISDEF  but  there  is  a 257. 
probability  that  the  actual  level  of 
interceptors  is  half  this  large, 

LOWFAC  = .5  and  PROBLOW  = .25.  These 
factors  apply  to  every  target  with 
terminal  BMD. 


PROBLOW  0. 0-1.0  0.0 


Serves  the  same  function  as  I/JWFAC, 
except  that  it  represents  the  upper 
estimate  of  terminal  ballistic  missile 
capability. 


HIGHFAC  >0.0 


Same  function  as  PROBLOW  except  that 
it  is  the  probability  of  occurrence 
of  the  upper  defense  estimate  HIGHFAC 


PROBHIGH  0. 0-1.0  0.0 


Specifies  the  form  of  damage  law  used 
on  ares  targets  (i.e.;  targets  with 
RADIUS  >0.0).  If  it  is  equal  to 
SQUARE  the  square  root  damage  law 
is  used.  Otherwise,  the  power  (or 
exponential)  law  is  used  on  area  tar- 
gets. 


SQUARE 

or 

POWER 


Acts  as  a multiplier  for  the  number  of 
terminal  BMD  defense  interceptors  over 
the  entire  target  system. 


TINTFAC  >0.0 


Acts  as  a multiplier  for  the  entries 
in  the  SMAT  array.  Decreasing  the 
value  of  CORR  reduces  the  effect  of 
irterweapon  correlations.  (With  the 
default  SMAT  array,  the  value  of  CORR 
should  not  exceed  .5  for  good  results.) 


CORR 


Table  3.  (Part  3 of  6) 


NAME  RANGE  DEFAULT  DESCRIPTION 

C0RR2  0. 0-1.0  0.0  Optional,  to  evaluate  the  final  weapon 

allocation  with  a different  multiplier 
for  the  SMAT  array  values . Used  in 
conjunction  with  the  user-input  param- 
eter IVERIFY . 

FACMIRV  0. 0-1.0  0.0  Modifies  the  SMAT  array  for  MIRV  sys- 

tems. For  weapons  with  a MIRV  capabil- 
ity, the  values  of  the  SMAT  array  cor- 
responding to  the  GROUP  attribute  for 
failure  modes  SBL,  CC,  and  REL  (see 
table  4)  are  increased  by  the  produce 
of  FACMIRV  and  the  unassigned  variance 
for  those  failure  modes.  (For  the  de- 
fault SMAT  array,  table  5,  the  unassigned 
variance  for  SBL  is  .30,  for  CC  is  .30, 
and  for  REL  is  .65.)  Table  6 provides 
two  examples  of  the  SMAT  array  for  MIRV 
systems:  when  the  default  SMAT  array 
is  used  in  conjunction  with  FACMIRV  = 

0.5,  and  when  it  is  used  with  FACMIRV 
= 1.0.  For  examples  of  this  effect  of 
this  parameter  see  table  6. 


RINTPRD  >1.0  2.0  Approximate  ratio  between  rate  of 

change  of  target  weights  between  dif- 
ferent integration  periods.  An  in- 
crease in  this  parameter  increases 
the  sensitivity  of  the  multiplier  ad- 
justment to  recent  target  experience. 


RATIOINT  ^0.0  2.0  Ratio  of  longest  integration  period 

used  to  the  theoretical*--a  low  value 
allows  higher  sensitivity  without  os- 
cillations in  the  values  of  the  La- 
grange multipliers,  but  too  low  a 
value  makes  convergence  to  the  correct 
stockpile  sensitive  to  statistics  of 
the  target  list.  If  the  target  list 
contains  targets  with  heavy  ballistic 
missile  defenses  or  if  a large  frac- 
tion of  the  weapons  is  assigned  by  the 
fixed  assignment  capability,  this  param- 
eter value  shoe  Id  oe  increased  (to  4.0 
or  above  if  necessary). 


I 
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name  range  default  description 

ERRCLOS  0. 0-1.0  .001  Provides  one  control  of  the  termina- 

tion of  weapon  allocation  processing 
(ALLOCATE  function).  If  VALERR  < 
VALWPNS  * ERRCLOS,  where  VALERR  is 
the  absolute  value  of  the  sum  of  the 
Lagrange  multipliers  for  all  under-or- 
over-allocated  weapons,  and  VALWPNS  is 
the  sum  of  the  Lagrange  multipliers  for 
all  weapons  in  the  stockpile,  then  the 
weapon  allocation  process  will  termin- 
ate normally.  The  complete  set  of  nor- 
mal terminating  conditions  for  this 
function  is  described  in  the  Termina- 
tion of  ALLOCATE  Function. 

ATTPOS  0-9  0 If  = 0 all  weapon  groups  are  allocated. 

If  / 0 only  those  groups  such  that 
ATTINC  = ATTPOS  are  allocated  (All 
fixed  assignments  take  effect  regard- 
less of  the  value  of  ATTPOS) . 


1 

' 


SNSTVTY  - .1  FSNSTVTY  = 1 CLOSE  =1.05  DELTVAL  = .005  PRM  = .5 
STALADJ  = .5  CLOSER  = 4 QUALITY  - .5  IVERIFY  = 0 
SETTLE  = 1 ERRCLOS  = .001 


The  ATTPOS  attribute  resides  in  the  NUMTBL  record  and  may  be  changed  as 
follows : 


CHANGE  WHERE  CLASS  - NUMBER  SETTING  ATTPOS  = 1 

3.2.11  The  SMAT  Clause.  Through  this  clause  the  user  enters  and/or 
saves  values  for  the  SMAT  array.  The  row  and  column  labels  for  this 
array  and  their  meaning  is  shown  in  table  4.  The  clause  consists  of 
a series  of  labels  and  values  separated  by  commas.  Each  J Index  label 
encountered  causes  this  index  to  be  set.  Each  I index  label  has  a sim- 
ilar function.  When  a value  is  encountered  it  is  entered  in  the  array 
at  the  current  setting  of  the  I and  J indexes.  To  cause  the  settings 
to  be  permanently  entered  for  later  runs  the  user  follows  the  adverb 
with  the  special  word  UPDATE.  An  example  which  would  set  the  SMAT 
array  as  per  the  defaults  shown  in  table  5 would  be: 

SMAT  UPDATE  ALL, SBL,0,CC, OREL, 0, PEN, 0,STK,0, GROUP, 0, REGION, 0, 
CLASS, 0, TYPE, 0, ALERT, 0, PEN, 0 REL,0  CC,0,SBL,0, TYPE, . 1 .CLASS , .4, 
REGION, . 1 .GROUP, . 1 ,CC , . 2 ,REL, . 05 , PEN , 0 .REGION, . 1 .CLASS , . 2 , 

TYPE , . 2 ,REL, . 2 ,CC , . 1 .CLASS , . 1 .REGION , . 3 ,REL, 0 .CLASS , . 1 

Each  value  entered  should  lie  between  0.  and  1.  and  the  sum  of  all  ele- 
ments with  the  same  failure  made  index  J must  be  less  than  or  equal  to 
1. 

3.3  Output 

3.3.1  Standard  Output.  The  printed  output  of  the  ALOC  module  may  be 
divided  into  four  parts:  Input  prints,  standard  allocation  prints,  de- 
tailed prints,  and  debug  prints.  Most  of  these  may  be  controlled  via 
user  option  selection.  Those  which  are  not  controlled  or  which  always 
appear  at  a certain  point  will  be  noted  as  such. 
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Table  4.  Acceptable  Values  for  SMAT  Array  Indices 


J Index.  Failure  Modes 

" ' I ' ■ 


J 

MNEMONIC 

DESCRIPTION 

1 

SBL 

Survival  before  launch 

2 

CC 

Reliability  of  command  and  control  system 

3 

REL 

Weapon  system  hardware  reliability 

4 

PEN 

Penetration  probability 

5 

STK 

Probability  of  target  kill  by  warhead 

I Index.  Weapon  Attributes 


I_ 

NAME 

DESCRIPTION 

1 

ALL 

Shared  by  all  weapons  in  the  stockpile 

2 

GROUP 

Weapons  of  same  class,  type,  region,  and  alert 
status  whose  launch  bases  are  close  to  one 
another 

3 

REGION 

Region  of  launch  base 

4 

CLASS 

Weapon  class,  either  bomber  or  missile 

5 

TYPE 

Weapon  type  (e.g.,  B-52G,  Poseidon) 

6 

ALERT 

The  alert  status  of  the  weapon,  either  alert 
or  nonalert 

Table  5.  Default  Values  for  SMAT  Array 


ATTRIBUTES 

I * 

1 

2 

3 

4 

5 

6 

J 

ALL 

GROUP 

REGION 

CLASS 

TYPE 

ALERT 

1 SBL 

0 

.10 

.10 

.40 

.10 

0 

FAILURE 

2 CC 

0 

.20 

.30 

.10 

.10 

0 

3 REL 

0 

.05 

0 

.10 

.20 

0 

MODES 

4 PEN 

0 

0 

.10 

.20 

.20 

0 

5 STK 

0 

0 

0 

0 

0 

0 

I 
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Figure  18.  ALOC  Input  Print  (Part  1 of  4) 


Figure  18.  (Part  2 of  4) 


SECTION  5.  MODULE  ALOCOUT 


5.1  General  Purpose 

Module  ALOCOUT  selects  optimal  aim  point  offsets  for  weapons  allocated 
to  complex  targets  and  reorders  the  weapon  group  assignment  chains  for 
use  within  the  Sortie  Generation  subsystems.  For  missile  groups,  the 
sort  in  according  to  salvo  number  and  within  salvo,  according  to  attri- 
bute RVAL.  For  bomber  groups  the  new  order  is  a collection  of  strikes 
belonging  to  the  penetration  corridor  that  has  the  largest  number  of 
assignments  followed  by  strikes  of  the  penetration  corridor  that  has 
the  next  largest  number  of  assignments  and  so  on.  Within  each  collec- 
tion of  strikes  belonging  to  the  same  penetration  corridor,  the  assign- 
ments are  further  sorted  based  on  attribute  RVAL.  The  user  should  note 
that  if  attribute  ATTPOS  / 0,  only  those  weapon  groups  where  ATTINC  = 
ATTPOS  are  reordered. 


5.2  Input 


The  only  options  available  to  the  user  in  module  ALOCOUT  are  to  specify 
the  type  and  frequency  of  the  various  prints  and/or  to  specify  the  maxi- 
mum number  of  iterations  to  be  executed  by  the  generalized  function  mini- 
mizes which  is  used  to  select  the  aim  point  offsets  for  those  weapons 
assigned  to  complex  targets.  The  general  command  is: 


DGZSELECT 


ONPRINTS  option  option 
FINDMIN  imaxl 


5.2.1  The  ONPRINTS  Adverb.  This  adverb  selects  various  print  or  calcu- 
lation options.  It  recognizes  any  series  of  numbers  (each  number  separ- 
ated by  at  least  one  blank)  with  values  varying  from  one  to  nine.  The 
presence  of  any  of  the  numbers  within  the  clause  selects  the  correspond- 
ing option  which  are: 

o 1 — Selects  the  detailed  target  print.  For  this  option  only 

a print  frequency  may  be  selected.  This  is  entered  by 

placing  a slash  (/)  after  the  number  one  followed  by  the 
numeric  value  of  the  desired  print  frequency.  An  entry  of 
1/10  will  print  every  ten  targets.  The  default  entry  (1 
by  itself)  prints  all  targets 

o 2 — Selects  the  lomber  weapon  group  summary  print 

o 3 — Selects  the  missile  weapon  group  summary  print 

o 4 — If  entered  offsets  are  not  calculated 

o 5 — Selects  the  target  data  input  to  subroutine  DGZSEL  print 

o g — Selects  the  DGZSEL  computational  value  print 


o 7 — Selects  the  DGZSEL  improvement  print 

o 8 — Selects  maintenance  prints 

o 9 — Selects  timing  information  print 

5.2.2  The  FINDMIN  Adverb.  If  absence  the  FINDMIN  subroutine  is  not 
used.  If  present  the  FINDMIN  subroutine  is  used  and  parameter  ' imax' 
is  set  to  the  maximum  number  of  iterations. 

5. 3 Output 

5.3.1  Standard  Output.  All  output  is  optional  and  must  be  selected  by 
the  user. 

5.3.2  Nonstandard  Output.  Figures  57  to  60  presents  the  output  for 
print  options  available  to  the  user  within  the  ONPRINTS  clause. 

5.3.3  ALOCOUT  Error  Messages.  The  error  messages  for  ALOCOUT  are  shown 
in  figure  61. 


